home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1997 #1 / Amiga Plus Extra 1997 #1.iso / programme / tools / darksound / docs / darksound.eng.doc next >
Text File  |  1996-10-15  |  11KB  |  319 lines
  1. *****************************************
  2. *        `DarkSound'  V 2.5        *
  3. *       An OriginalWare release by      *
  4. *    Troglobyte/Darkness © 1996    *
  5. *****************************************
  6. $VER:DarkSound.doc v2.5 15.November.96 Troglobyte/Darkness
  7.  
  8. Contents
  9. ========
  10.  
  11.  1. Introduction
  12.  2. Instructions
  13.  3. ToolTypes
  14.  4. Errors and solutions
  15.  5. History
  16.  6. Bugs
  17.  7. OriginalWare?
  18.  8. Also available...
  19.  9. Thanks to...
  20. 10. Credits
  21.  
  22.  
  23. 1. Introduction
  24. ===============
  25.  
  26. Are  you  tired  of  hearing the same sound alert each time the Amiga warns
  27. you?
  28.  
  29. DarkSound  is the answer to your prayers!  It will randomly choose a sample
  30. each time you boot your machine.Now, your errors won't sound the same 8).
  31.  
  32. DarkSound  will  play  a  random  Start sample anytime you load it and will
  33. select another random Alert sample to be used as the system sound Alert.
  34.  
  35. DarkSound  is  very  easy  to  install,  and  once installed you can't live
  36. without  it,  and  with  the  correct sample you can always surprise others
  37. Amiga and PC users, you even can surprise yourself.
  38.  
  39. If you think the sources (100% assembler) could be useful for you (to include
  40. in a program you are developing or for learning purposes) just contact me and
  41. ask for them.
  42.  
  43.  
  44. 2. Instructions
  45. ===============
  46.  
  47. To  install  DarkSound just drag his icon to the `DH0:WBStartup' drawer, or
  48. copy  the  `DarkSound'  and `DarkSound.info' to you `SYS:WBStartup' drawer.
  49. Then  configure  the ToolTypes of the icon (for more info look at Section 3
  50. of this instructions:  3.  ToolTypes)
  51.  
  52. DarkSound  (optionally)  will play another sample each time you run it; and
  53. as DarkSound must be installed in your `WBStartup' drawer, this sample will
  54. play  anytime  you init your WorkBench, you can use this sample to warn you
  55. that your Workbench finished loading and your Amiga is ready to be enjoyed.
  56. After  this DarkSound will select another random Alert sample to be used as
  57. the  system sound Alert and then will exit.  Both samples are selected from
  58. different sound lists that you must define in the DarkSound icon ToolTypes.
  59. I  recommend  to  use  longer sounds as Start samples and shorter sounds as
  60. Alert samples, but you can use whatever you want.
  61.  
  62. The  sound  samples  provided  are  only  for  test, use your own favourite
  63. sounds.
  64.  
  65. You  can use the `DH0:Prefs/Sound' preferences editor, to select the volume
  66. of  the  samples  and  if  you want a screen flash together with the System
  67. Alert sample.
  68.  
  69. When  DarkSound  is  executed  it  change  your  sound  prefs  and exit, so
  70. DarkSound don't waste nothing of your precious CPU time and memory.
  71.  
  72. DarkSound  only edit your RAM:  configuration (RAM:ENV/Sys/Sound.Prefs), so
  73. DarkSound never WRITE nothing to your Hard Disk.
  74.  
  75. All this is more simple than it sounds #8>) so just check it.
  76.  
  77.  
  78. 3. ToolTypes
  79. ============
  80.  
  81. Now you can/must configure DarkSound with the icon ToolTypes.
  82.  
  83. To  edit configuration, click once the DarkSound icon and press right mouse
  84. button  to  select  in the Workbench menu `Icons' the `Information' option,
  85. you  can  select it pressing at the same time the right `Amiga' key and the
  86. `I' key.Then a window will appear to easily write your own configuration.
  87.  
  88. There are 2 ToolTypes to select the Start sample :
  89.  
  90.  ToolType 1 : Start_Name=dh0:Sounds/Sample00.Iff
  91. With  this  you  select  the  path and name of the Start sample you want to
  92. play.   Remember  that  all the samples must have the same name, and a `00'
  93. string anywhere in the name of the sample, but the Sample00 isn't used.
  94.  Examples :
  95. dh1:Sounds/Sound00    - OK
  96. SYS:Sample.00.IFF    - OK
  97. DH0:Sound13        - Bad : the number must be 00 (Sound00, OK)
  98. dh1:Sound000        - Bad : the number must be 2 digit only (Sound00)
  99.  
  100.  ToolType 2 : Start_Number=03
  101. This  is  the number of samples.  If the number is `00' the Start Sample is
  102. OFF.
  103.  Example :
  104. With this ToolTypes,
  105.  START_NAME  =dh0:Sounds/Sample00.Iff
  106.  START_NUMBER=03
  107. you must have the samples :
  108.  dh0:Sounds/Sample01.Iff
  109.  dh0:Sounds/Sample02.Iff
  110.  dh0:Sounds/Sample03.Iff
  111.  
  112. There  are  other  2  ToolTypes  to  select  the  System Alert sample, this
  113. ToolTypes  are  used  like  the  previous 2 ToolTypes, you can use the same
  114. samples or other samples.
  115.  
  116.  ToolType 3 : Alert_Name  =dh0:Sounds/Alert00.Iff
  117.  
  118.  ToolType 4 : Alert_Number=07
  119.  
  120. The other ToolTypes are standard Workbench ToolTypes, and usually you don't
  121. need to change them; if you don't know what they do, don't touch them.
  122.  
  123.  ToolType 5 : StartPriority=0
  124. This  ToolType  is  used  to  select  in which order WBStartup programs are
  125. loaded, if you use the Start sample I recomend to load DarkSound the last.
  126.  
  127.  ToolType 6 : DoNotWait
  128. This ToolType tell the system Do Not Wait to this program to finish, so the
  129. system continue loading other programs while executing DarkSound.
  130.  
  131.  
  132. 4. Errors and solutions
  133. =======================
  134.  
  135. If  you  have  any problem `DarkSound' will open a window to display the
  136. errors found, it will help you to check out your problems.
  137.  
  138. WorkBench 2.1 or later required by DarkSound to work (if you have KickStart
  139. 1.x consider DarkSound another good reason to upgrade your Amiga).
  140.  
  141. The  file  `RAM:ENV/Sys/Sound.Prefs' is required, if you don't have it, use
  142. the `SYS:Prefs/Sound' program to create it and select your preferences.
  143.  
  144. Remember  that  your old `sound.prefs' sample selections are overwritten by
  145. DarkSound  in  RAM:   but  are  still  in your hard disk, so if one day you
  146. decide   to  stop  using  DarkSound,  your  original  preferences  will  be
  147. automatically used again.
  148.  
  149. If you get the system error `Sound.Prefs is a BAD Prefs File', then one
  150. of your sounds isn't a standard IFF sample, check them with a sound program.
  151. There can be only 100 samples, but this must not be a problem (I think).
  152.  
  153. If you have any other problem or doubt, contact me (address is at the end)
  154.  
  155.  
  156. 5. History
  157. ==========
  158.  
  159. Version 1.1 ( 8-Apr-94) :
  160.   - First released version.
  161.  
  162. Version 1.2 (20-May-94) :
  163.  - Play the LAST sound in the list when run it to alert you that your
  164.    WorkBench is loaded, (you can use a long sample like `Commodore is
  165.    dead but your Amiga is still the best computer  and is ready to be
  166.    used' and use smaller samples as alerts) and choose another sample
  167.    randomly for the WB Sound Alert.
  168.  - Improved Docs.
  169.  - MagicWB Icon added.
  170.  - More Samples included (but not good enough yet). 
  171.  
  172. Version 1.3 (20-Sep-94) :
  173.  - If you use it from CLI will display errors.
  174.  - Code optimized for future versions.
  175.  - FIDO address added :-)
  176.  
  177. Version 2.0 (10-Nov-94) :
  178.  - Major update.
  179.  - Different sound lists for Start and Alert samples.
  180.  - Added ToolTypes for configuration.
  181.  - Docs in AmigaGuide format.
  182.  - Spanish docs added.
  183.  
  184. Version 2.2 (6.Jan.1995) :
  185.  - The program don't open a window (except if there is any problem).
  186.  
  187. Version 2.5 (15.Nov.1996) :
  188.  - DarkSound can be renamed and placed in any directory you want.
  189.  - ToolTypes with 1 or 2 numbers are accepted.
  190.  - A nasty bug fixed that was responsible for some Gurus.
  191.  - Doc updated.
  192.  
  193.  
  194. 6. Bugs
  195. =======
  196.  
  197. There isnt anymore KNOWN bugs at the moment in all the Amigas tested but...
  198.  
  199. If you find any bug or problem, contact me at the address at the end.Please,
  200. send me a detailed report of the problem and of your Amiga computer if
  201. possible; thanks.
  202.  
  203. If you found the problem with a particular file, send me too a copy of
  204. the file.
  205.  
  206. Don't forget to tell me the current version of my program you are using.
  207.  
  208.  
  209. 7. OriginalWare ?
  210. =================
  211.  
  212. This  utility  is OriginalWare.That means if you like this program you must
  213. buy  an  original Amiga program or game, or send the money to the author of
  214. any ShareWare program or game you are using often.
  215. (This includes me, $5 or $10 will be welcome *8)
  216.  
  217. There  are  lots  of  great Amiga software like `DiskMaster', `Remind',
  218. `MultiCX', `Spot', `ReqTools.library', `Deluxe Galaga', `APlayer' and a
  219. lot more that you won't never regret to spend your money.
  220.  
  221. If you do this you support the Amiga, and if you support AMIGA you support
  222. US.
  223.  
  224. Support software authors and you will get more and better software.
  225.  
  226. This program could be included in any PD compilation at a symbolic price.
  227.  
  228. This program could be freely included in any Web page or FTP site, but
  229. send me an EMail to know it.(I can include the address in this doc) 
  230.  
  231. Aminet and Fred Fish collections are specifically allowed to include it.
  232.  
  233.  To Magazines :
  234. You can give away this utility on your coverdisk, but please send me a copy
  235. of the magazine.
  236.  
  237.  
  238. 8. Also available...
  239. ====================
  240.  
  241. Others quality Amiga PD products available from me :
  242.  
  243. Aminet recent uploads :
  244.  
  245. DKSound.lha           util/boot    53K  v2.5 Changes Workbench Sounds each boot.
  246. HTMLess.lha           text/misc    12K  v2.1 Converts HTML files in text files.
  247. MagiCA64.lha          misc/emu      6K  v1.1 Convert A64/C64 to MagiC64 format.
  248. Progress.lha          demo/intro   73K  In Progress/Darkness.1st at Euskal Party
  249. Vectoram.lha          dev/misc     15K  v1.3 Draw/edit 2D vectors for demos/game
  250. TheRace5.lha          game/2play   59K  v1.5 Great 100m Running game,0-4 players
  251.  
  252. Available soon:
  253.  
  254. ELF.lha               text/misc            v1.0 Erase Line Feeds.For Word Procesor.
  255. FormaText.lha         text/misc            v1.0 Format texts to chosen columns size 
  256.  
  257. All them are 100% written in pure assembler for speed and are very system 
  258. friendly in all types of Amiga computers (or that is what I hope *8).
  259.  
  260.  
  261. 9. Thanks to...
  262. ===============
  263.  
  264. Amiga Vice for the idea and the ßeta testing.
  265.  
  266. Hipnooxis for ALL the help and show me to use and respect the Amiga O.S.
  267.  
  268. Binary for the help with the first docs.
  269.  
  270. Alberto Sanchez y David Santamaria for some help.
  271.  
  272. Knackosoft/TRSI for being my best `invisible' friend.
  273.  
  274. To the `Atletico de Madrid', the best football team in Spain.
  275.  
  276. To all the Amiga developers for all the new, fun and useful stuff.
  277.  
  278. To Aminet for archive all the Amiga software (and for the free CD's too *8)
  279.  
  280. To all the Amiga users worldwide for their trust in the Amiga.
  281.  
  282. To Amiga Technologies for putting the Amiga in the production line again.
  283.  
  284. To VISCorp for...only the future will tell us.
  285.  
  286. To the Amiga.
  287.  
  288.  
  289. 10. Credits
  290. ===========
  291.  
  292. All code © 1996 by Troglobyte/Darkness.
  293. Idea by Amiga Vice/Darkness.
  294. The authors of the samples provided.
  295.  
  296. Send money($), JOB offers, BUGS, comments, improvements, ideas, suggestions,
  297. disks,  mags,  advices,  complains,  nice  PD  stuff  (like Demos, Games or
  298. Utilities),  and your favourite IFF Sounds samples to include in future and
  299. better versions of this utility :
  300.  
  301.             M. Martin Vivaldi
  302.              Av. America 60
  303.               Madrid 28028
  304.                  SPAIN
  305.  
  306. Or NetMail me at :
  307.  
  308.  Internet : bitabit@servicom.es (Faster and safer)
  309.  
  310.  FidoNet  : 2:341/28.55        Manuel Martin
  311.  
  312.  AmigaNet : 39:192/1.29        Manuel Martin
  313.  
  314.  
  315. Remember:
  316.  
  317. Only Amiga make it possible... Only Amiga make it fun.
  318.  
  319.